Function: load(stringPath, domInsertionElement, objectData, functionSuccess(domElementToInsert, promiseObject), functionError(errorMessage, promiseObject))

Description: Performs a specialized Fetch API call to load external content into a DOM element.

Returns: domElement, or $A object if chained.

Note: The objectData setting may be used to customize the Fetch API functionality, as documented within "Help/$A API/Import and Fetch APIs/Get".

Example:

// Load content from an external resource into a DOM element.
$A.load("path/src/resource.html", domContainerElement, {
  selector: "#content-section" // Extracts the external element with id="content-section"
});

// Load content from an external resource into a DOM element and exicute a callback when complete.
$A.load("path/src/resource.html", domContainerElement, {
  selector: "#widget" // Extracts the external element with id="widget"
},
function(domWidgetElement) {
  // Do something with domWidgetElement
});

// Or the same using chaining

// Load content from an external resource into a DOM element.
var myChain = $A(domContainerElement).load("path/src/resource.html", {
  selector: "#content-section" // Extracts the external element with id="content-section"
});

// Load content from an external resource into a DOM element and exicute a callback when complete.
var myChain = $A(domContainerElement).load("path/src/resource.html", {
  selector: "#widget" // Extracts the external element with id="widget"
},
function(domWidgetElement) {
  // Do something with domWidgetElement
});

// To return the modified element within a chain, use the "return()" method.

var myElement = myChain.return();